home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / AVIATHER / WEATH13.LZH / WEATHER.DOC < prev    next >
Text File  |  1987-01-21  |  10KB  |  222 lines
  1. *******************************************************************************
  2. *                        WEATHER RECORDS AND STATISTICS                       *
  3. *                                  Version 1.3                                *
  4. *                                                                             *
  5. *                                                                             *
  6. *             Public-Domain Software for the IBM Personal Computer            *
  7. *                                                                             *
  8. *                To Display Records Stored in a Weather Database              *
  9. *                  And Statistics Calculated from the Database                *
  10. *                                                                             *
  11. *                             By Martin E. Morrison                           *
  12. *                             136 Loma Verde Drive                            *
  13. *                             Hayward, CA 94541-1368                          *
  14. *                             Telephone:  (415) 278-8458                      *
  15. *                             CompuServe:  70315,101                          *
  16. *******************************************************************************
  17.  
  18.  
  19.  
  20.                                     The Files
  21.                                     ---------
  22.  
  23. WEATHER consists of four files:
  24.  
  25.      WEA0000.DAT   a weather database template
  26.      WEA1986.DAT   a sample weather database
  27.      WEATHER.DOC   this documentation file
  28.      WEATHER.EXE   the weather records and statistics program
  29.  
  30.  
  31.  
  32.                                  Using WEATHER
  33.                                  -------------
  34.  
  35. WEATHER.EXE is the executable file that is run directly from the PC-DOS prompt.
  36. You should make sure that any annual weather datafiles you intend to use
  37. (explained under "The Annual Weather Datafiles" below) are resident with
  38. WEATHER.EXE on your current device and directory.
  39.  
  40. WEATHER first asks you to input the name of the annual weather datafile to be
  41. used.  (As explained under "The Annual Weather Datafiles" below, the weather
  42. data for each calendar year should be stored in a separate file with a filename
  43. you designate.)  If you input a filename that does not exist, WEATHER will
  44. warn you with a beep and a "***FILE NOT FOUND***" message and then allow you to
  45. input a filename again.
  46.  
  47. WEATHER then displays the "Reading records in from file [filename]" message and
  48. displays the date of each record as it is read in, so that you can follow the
  49. progress of reading in the records.  If you see any errors (e.g., dates in the
  50. wrong format or extraneous characters) as the display increments or if you
  51. receive an "Input past end" error message, check at the date where the error
  52. occurred for typographical errors, particularly punctuation errors, in the
  53. annual weather datafile you used.  If you receive an "Input past end" error
  54. message after the last date, check the end of your datafile for the presence of
  55. more than one carriage return (blank lines) after the last line of data.
  56.  
  57. WEATHER then displays the Options Menu as follows:
  58.  
  59.      (1) Display or print weather records
  60.      (2) Display or print weather statistics
  61.      (3) Choose another annual weather datafile
  62.      (4) Exit
  63.  
  64. If you select option 1 or 2, you will be prompted for the following
  65. information:
  66.  
  67.      Input starting date (YY-MM-DD)
  68.      Input ending date (YY-MM-DD)
  69.      Input city location (10 letters maximum)
  70.      Input state location (2-letter state code)
  71.      Printout also (yes/NO)
  72.  
  73. As WEATHER searches for the dates in ASCII order, you need enter only YY or
  74. YY-MM, if you desire a year or year-month combination.  However, you must enter
  75. leading zeros (e.g., 86-03-04).  If you enter a carriage return at the "Input
  76. starting date" prompt, WEATHER returns to the Options Menu.  The printout
  77. default is "no" (display on monitor screen only).
  78.  
  79. If you select option 1, WEATHER displays or prints the following fields
  80. from the database for each record between the starting and ending dates:
  81.  
  82.      Date
  83.      Low Temperature
  84.      Time of Low Temperature
  85.      High Temperature
  86.      Time of High Temperature
  87.      Atmospheric Pressure
  88.      Rainfall
  89.  
  90. If you select option 2, WEATHER calculates and displays or prints the
  91. following statistics from the database for the records between the starting and
  92. ending dates the accuracy of the statistics is, of course, dependent upon the
  93. completeness of the records entered into the database):
  94.  
  95.      Extreme Low Temperature (with date and time of day)
  96.      Extreme High Temperature (with date and time of day)
  97.      Extreme Low Pressure (with date)
  98.      Extreme High Pressure (with date)
  99.      Extreme Low Rainfall (with date)
  100.      Extreme High Rainfall (with date)
  101.      Average Low Temperature (with average time of day)
  102.      Average High Temperature (with average time of day)
  103.      Average Atmospheric Pressure
  104.      Average Rainfall
  105.      Total Rainfall
  106.  
  107. If you select option 3, WEATHER allows you to input the name of another annual
  108. weather datafile to use with options 1 and 2.
  109.  
  110. If you select option 4, WEATHER exits to DOS.
  111.  
  112.  
  113.  
  114.                          The Annual Weather Datafiles
  115.                          ----------------------------
  116.  
  117. WEA1986.DAT, consisting of the 1986 weather data for Hayward, California, is
  118. supplied as a sample to demonstrate the format for entering data into an
  119. annual weather datafile to be used by WEATHER.  This file is a standard ASCII
  120. file that may be listed using the PC-DOS "TYPE" command.
  121.  
  122. Because of restrictions on string space imposed by the IBM BASIC Compiler, the
  123. weather data for each calendar year should be stored in a separate file under a
  124. name you designate for each (e.g., WEA1986.DAT).  It is possible to maintain
  125. annual weather datafiles for more than one location; however, each location's
  126. annual datafile must be maintained separately under a different filename, and
  127. only one location's annual datafile may be used by WEATHER at a time.
  128.  
  129. First, inspect the sample file, which is an ASCII file, by using the PC-DOS
  130. "TYPE" command.  Then, observe WEATHER's operation by running it and inputting
  131. WEA1985.DAT when prompted to input the name of the annual weather datafile to
  132. be used.
  133.  
  134. As your annual weather datafiles must be ASCII files, you may enter them by
  135. using EDLINE (the PC-DOS line editor), WordStar's non-document mode, or any
  136. other editor that an ASCII file consisting only of letters, numbers, and
  137. punctuation.  You should particularly note the following requirements for
  138. entering data:
  139.  
  140.      * You must enter each days' record serially, earliest date first, in
  141.        exactly the same format as the sample file with respect to spacing,
  142.        punctuation, etc.
  143.  
  144.      * You must enter the abbreviation "n/a" ("not available") when you are
  145.        missing any datum.
  146.  
  147.      * You must not enter extra spaces at the end of a line before the carriage
  148.        return or enter extra carriage returns (blank lines) after the last line
  149.        of data.
  150.  
  151. A template file (WEA0000.DAT) is provided for entering 365 days of weather
  152. records into an annual weather datafile.
  153.  
  154.  
  155.  
  156.                                  The Units Used
  157.                                  --------------
  158.  
  159. WEATHER is programmed so that all data need to be stored, displayed, and
  160. printed in the American National Standards Institute (ANSI)- and International
  161. Standards Organization (ISO)-recommended SI metric system units, which have
  162. also been approved by the U.S. National Weather Service.  The units are as
  163. follows:
  164.  
  165.      Dates:  YY-MM-DD format
  166.      Times:  HH:MM format using a 24-hour clock
  167.      Temperatures:  degrees Celsius (to one decimal place)
  168.      Pressures:  kilopascals (to three decimal places)
  169.      Rainfall:  millimetres (to one decimal place)
  170.  
  171. If your instruments do not give readings in SI metric units, you must convert
  172. your readings to SI metric units before entering them into your annual weather
  173. datfile.  The conversion formulae are as follows:
  174.  
  175.      Degrees Fahrenheit to Degrees Celsius:  (X-32)*5/9
  176.      Millibars to Kilopascals:  X/10
  177.      Inches of Mercury to Kilopascals:  X*3.386389
  178.      Inches to Millimetres:  X*25.4
  179.  
  180. Two excellent instruments that do give readings in SI metric units are
  181. available through the Edmund Scientific Catalog, 101 East Gloucester Pike,
  182. Barrington, NJ 08007.
  183.  
  184.      COMPUTEMP.  Monitors indoor and outdoor temperature and time of day.
  185.      Records the day's high and low temperatures in degrees Celsius and the
  186.      time they occurred.  Catalog No. H61,236.  $79.95.
  187.  
  188.      DESK BAROMETER.  Calibrated in millibars (hectopascals), which can easily
  189.      be converted to kilopascals by dividing by 10.  Gilded case has a 100 mm
  190.      silver dial with black numerals and gold set band.  Catalog No. H41,951.
  191.      $19.95.
  192.  
  193.  
  194.  
  195.          ----------------end-of-author's-documentation---------------
  196.  
  197.                         Software Library Information:
  198.  
  199.                    This disk copy provided as a service of
  200.  
  201.                         The Public (Software) Library
  202.  
  203.                   Disks in the library are updated monthly.
  204.          For a copy of the latest monthly software library newsletter
  205.           and a list of the 800+ disks in the library, call or write
  206.  
  207.                         The Public (Software) Library
  208.                             P.O.Box 35705, Rm. F
  209.                            Houston, TX 77235-5705
  210.                                (713) 721-6104
  211.  
  212.          We are not the authors of this program, nor are we associated
  213.          with the author in any way other than as a distributor of the
  214.          program in accordance with the author's terms of distribution.
  215.  
  216.          Please direct shareware payments and specific questions about
  217.          this program to the author of the program, whose name appears
  218.          elsewhere in  this documentation. If you have trouble getting
  219.          in touch with the author,  we will do whatever we can to help
  220.          you with your questions.
  221.  
  222.